home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / Composite.z / Composite
Encoding:
Text File  |  2003-11-18  |  8.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _C_o_m_p_o_s_i_t_e - The Composite widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #_i_n_c_l_u_d_e <_X_m/_X_m._h>
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       Composite widgets are    intended to be containers for other
  16.       widgets and can have an arbitrary number of children.     Their
  17.       responsibilities (implemented    either directly    by the widget
  18.       class    or indirectly by Intrinsics functions) include:
  19.  
  20.       +o    Overall management of children from creation to
  21.            destruction.
  22.  
  23.       +o    Destruction of descendants when the composite widget is
  24.            destroyed.
  25.  
  26.       +o    Physical    arrangement (geometry management) of a
  27.            displayable subset of managed children.
  28.  
  29.       +o    Mapping and unmapping of    a subset of the    managed
  30.            children.  Instances of composite widgets need to
  31.            specify the order in which their    children are kept.
  32.            For example, an application may want a set of command
  33.            buttons in some logical order grouped by    function, and
  34.            it may want buttons that    represent filenames to be kept
  35.            in alphabetical order.
  36.  
  37.     CCCCllllaaaasssssssseeeessss
  38.       Composite inherits behavior and resources from _C_o_r_e.
  39.  
  40.       The class pointer is _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s.
  41.  
  42.       The class name is _C_o_m_p_o_s_i_t_e.
  43.  
  44.     NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  45.       The following    table defines a    set of widget resources    used
  46.       by the programmer to specify data.  The programmer can also
  47.       set the resource values for the inherited classes to set
  48.       attributes for this widget.  To reference a resource by name
  49.       or by    class in a .Xdefaults file, remove the _X_m_N or _X_m_C
  50.       prefix and use the remaining letters.     To specify one    of the
  51.       defined values for a resource    in a .Xdefaults    file, remove
  52.       the _X_m prefix    and use    the remaining letters (in either
  53.       lowercase or uppercase, but include any underscores between
  54.       words).  The codes in    the access column indicate if the
  55.       given    resource can be    set at creation    time (C), set by using
  56.       _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by    using _X_t_G_e_t_V_a_l_u_e_s (G), or is
  57.       not applicable (N/A).
  58.  
  59.                  CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee    SSSSeeeetttt
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      NNNNaaaammmmeeee         CCCCllllaaaassssssss             TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  75.      ______________________________________________________________________
  76.      XmNchildren     XmCReadOnly         WidgetList       NULL         G
  77.      XmNinsertPosition     XmCInsertPosition   XtOrderProc   NULL         CSG
  78.      XmNnumChildren     XmCReadOnly         Cardinal       0         G
  79.  
  80.  
  81.       _X_m_N_c_h_i_l_d_r_e_n
  82.            A read-only list    of the children    of the widget.
  83.  
  84.       _X_m_N_i_n_s_e_r_t_P_o_s_i_t_i_o_n
  85.            Points to the _X_t_O_r_d_e_r_P_r_o_c function described below.
  86.  
  87.       _X_m_N_n_u_m_C_h_i_l_d_r_e_n
  88.            A read-only resource specifying the length of the list
  89.            of children in _X_m_N_c_h_i_l_d_r_e_n.
  90.  
  91.       The following    procedure pointer in a composite widget
  92.       instance is of type _X_t_O_r_d_e_r_P_r_o_c:  Cardinal (*    XtOrderProc)
  93.       (wwwwiiiiddddggggeeeetttt)
  94.            _W_i_d_g_e_t     wwww;
  95.  
  96.       wwww    Specifies the widget.
  97.  
  98.       Composite widgets that allow clients to order    their children (usually
  99.       homogeneous boxes) can call their widget instance's insert_position
  100.       procedure from the class's insert_child procedure to determine where a new
  101.       child    should go in its children array.  Thus,    a client of a composite    class
  102.       can apply different sorting criteria to widget instances of the class,
  103.       passing in a different insert_position procedure when    it creates each
  104.       composite widget instance.
  105.  
  106.       The return value of the insert_position procedure indicates how many children
  107.       should go before the widget.    Returning zzzzeeeerrrroooo indicates that the
  108.       widget should    go before all other children; returning    num_children indicates
  109.       that it should go after all other children.  The default insert_position
  110.       function returns num_children    and can    be overridden by a specific composite
  111.       widget's resource list or by the argument list provided when the composite
  112.       widget is created.
  113.  
  114.     IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  115.       Composite inherits behavior and resources from the following
  116.       superclass.  For a complete description of each resource,
  117.       refer    to the manual page for that superclass.
  118.  
  119.                            CCCCoooorrrreeee    RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  120.      NNNNaaaammmmeeee                 CCCCllllaaaassssssss                 TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt             AAAAcccccccceeeessssssss
  121.      ______________________________________________________________________________________________________________
  122.      XmNaccelerators             XmCAccelerators             XtAccelerators   dynamic             CSG
  123.      XmNancestorSensitive         XmCSensitive             Boolean          dynamic             G
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX))))
  137.  
  138.  
  139.  
  140.      XmNbackground             XmCBackground             Pixel          dynamic             CSG
  141.      XmNbackgroundPixmap         XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  142.      XmNborderColor             XmCBorderColor             Pixel          XtDefaultForeground    CSG
  143.      XmNborderPixmap             XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  144.      XmNborderWidth             XmCBorderWidth             Dimension          1                 CSG
  145.      XmNcolormap             XmCColormap             Colormap          dynamic             CG
  146.      XmNdepth                 XmCDepth                 int          dynamic             CG
  147.      XmNdestroyCallback             XmCCallback             XtCallbackList   NULL             C
  148.      XmNheight                 XmCHeight                 Dimension          dynamic             CSG
  149.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True             C
  150.      XmNmappedWhenManaged         XmCMappedWhenManaged         Boolean          True             CSG
  151.      XmNscreen                 XmCScreen                 Screen *          dynamic             CG
  152.      XmNsensitive             XmCSensitive             Boolean          True             CSG
  153.      XmNtranslations             XmCTranslations             XtTranslations   dynamic             CSG
  154.      XmNwidth                 XmCWidth                 Dimension          dynamic             CSG
  155.      XmNx                 XmCPosition             Position          0                 CSG
  156.      XmNy                 XmCPosition             Position          0                 CSG
  157.  
  158.  
  159.     TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  160.       There    are no translations for    Composite.
  161.  
  162.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  163.       _C_o_r_e(_3_X).
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 11/11/03)
  196.  
  197.  
  198.  
  199.